initialize

open fun initialize(module: Module)

Initializes the control with its associated module context.

This method is typically called once before the control is first used or made active. It allows the control to set up its internal state, resources, and prepare for operation based on the provided data.

If #isAutoStart() is true, implementations might also trigger their start logic within or immediately after initialization.

Initializes the FlashView based on the provided com.reveldigital.player.api.Module data. This involves:
  • Identifying the SWF file path from the module's "File" option. The path is constructed relative to MainActivity.RevelRoot + "/Media/".
  • Constructing the flashVars string. All module options, except for "File", are URL-encoded and appended as key-value pairs (e.g., name1=value1&name2=value2).
  • Appending a "DeviceKey" FlashVar, using MainActivity.RegistrationKey. If MainActivity.RegistrationKey is null, an empty string is used for its value.
This method updates the internal this.module reference with the provided module. It should be called before start to ensure the Flash content is correctly configured. If the "File" option is not found, swf will remain null, and a warning will be logged.

Parameters

module

The com.reveldigital.player.api.Module data containing the configuration for this Flash content. This parameter effectively updates the internal this.module if it's different from the one passed in the constructor.